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TITLE OF THE INVENTION 

Middleware Brokering System Adapter 

CROSS-REFERENCE TO RELATED APPLICATIONS 
Not applicable. 

STATEMENT REGARDING FEDERALLY SPONSORED 
RESEARCH OR DEVELOPMENT 

Not applicable. 

REFERENCE TO A MICROFICHE APPENDIX 

Not applicable. 

FIELD OF THE INVENTION 

[0001] The invention relates to the field of communication within computer networks 
containing heterogeneous computer systems and more particularly to communication between 
systems connected by disparate middleware products. 

BACKGROUND OF THE INVENTION 
[0002] Computer systems operating under heterogeneous platforms cannot always exchange 
data directly among themselves. Numerous types of commercially available products known 
collectively as middleware have been developed to facilitate data exchange between disparate 
computer systems. Instead of communicating directly with each other, computer systems can send 
data in their native format to the middleware. The middleware then sends the data to another 
system in a format understandable by the second system. Among the categories of middleware are 
message-oriented middleware and object request brokers. 
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[0003] If a middleware product is not used, a heterogeneous computer system would typically 
need to operate in a point-to-point mode, for example using message queuing as point-to-point. 
Under the point-to-point approach, illustrated in Figure 1, if six separate and distinct applications 
120, 122, 124, 126, 128, and 130 are to communicate, connections 101-115 must be made between 
every possible pair of systems. This type of configuration is undesirable for several reasons. First, 
the number of connections is large. The number of connections required in a system of n 
components is (n - n)/2. For example, a six component system such as that in Figure 1 requires 
(36 - 6)/2 or 15 connections. Second, the point-to-point mode requires tight coupling between 
each pair of platforms. That is, if each type of technology uses its own data format, a specifically 
designed adapter is needed between each pair to allow communication between the two. Third, the 
point-to-point approach creates vendor dependency. The adapters between platforms must meet 
the requirements of the manufacturers of each system. If a piece of equipment is replaced, the 
adapters between the new equipment and all other systems must be redesigned. 
[0004] The use of middleware allows computer systems to operate in a broker mode, 
sometimes referred to as a hub and spoke configuration. This approach, as illustrated in Figure 2, 
is an improvement over the point-to-point approach. In this configuration, each application 220, 
222, 224, 226, 228, and 230 communicates only with the broker 232 thereby reducing the number 
of connections 201-206 needed. For example, this six-application system would require only six 
connections, numbered 201-206, as opposed to the fifteen needed for six applications connected in 
the point-to-point mode. Message-oriented middleware products operating in the publish/subscribe 
mode are an example of brokering middleware. Since these products can typically send and 
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receive data in the native data formats of the applications they connect, adapters are typically not 
needed to convert data from the format of the applications to the format of a publish/subscribe 
engine serving as the brokering hub. This reduces vendor dependency and increases system 
flexibility over the point-to-point approach. 

[0005] In the publish/subscribe paradigm, a packet of data in a specified format is called a 
message. An application that sends a message out is called a publisher and an application that 
receives a message is called a subscriber. The publisher sends its message to a central hub or 
publish/subscribe engine and includes information about the content of the message. Subscribers 
perform a process known as registration in which they inform the publish/subscribe engine about 
what types of message subject matter they are interested in. The publish/subscribe engine matches 
the content data from the publishers with the registration data from the subscribers and sends the 
messages to the appropriate subscribers. In this way, publishers can ensure that messages reach an 
interested audience and subscribers can ensure that unwanted messages are not received. The 
transmission of messages under the publish/subscribe approach is done in an asynchronous 
manner. That is, the publisher and the subscriber do not need to communicate with each other at 
the same time. The publish/subscribe engine can hold a published message until an interested 
subscriber retrieves it at a later time. Since applications typically can both send and receive 
messages, a particular application can act as a publisher and/or a subscriber at various times in the 
communication process. 

[0006] Among the commercial products that act as publish/subscribe message-oriented 
middleware are IBM's MQSeries and Sun Microsystems' s Java Message Service (JMS). The 
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MQSeries messaging system is described in more detail in the following reference publications, 
the entire contents of which are incorporated herein by reference: 
MQSeries for AIX V5.0 Quick Beginnings 

(http://www.software ibmxom/ts/mqseries/library/manuals/amqaac/AMQAACO 1 .HTM) 
MQSeries Application Programming Guide 

(http://www.software ibmxoWls/mqseries/library/maQuals/csqzal/CSQZALO 1 .HTM) 
MQSeries Application Programming Reference 

(http://www.softwareibmxom/ts/mqseries/libraiy/m 1 .HTM) 

MQSeries Using C++ 

(http://www.software ibmxom/ts/mqseries/library/manuals/amqzan/AMQZANO 1 .HTM) 

[0007] The JMS messaging system is described in more detail in the following reference 

publications, the entire contents of which are incorporated herein by reference: 

Java Message Service API 

(http://www.j avasoft.com/products/jms) 

Java Message Service Documentation 

(http://www.javasoft.com/products/jms/docs.html) 


[0008] Object request brokers are the other major category of middleware and their functions 
and capabilities have been standardized by the Object Management Group (OMG) in a 
specification known as the Common Object Request Broker Architecture (CORBA). The CORBA 
distributed object system is implemented under the CORBA specification from the OMG, Revision 
2.0, Revision 2.1, Revision 2.2, and Revision 2.3, all of which are incorporated herein by reference 
in their entirety. For purposes of this disclosure, a program compliant with CORBA Revision 2.3, 
2.2, and 2.1 by definition will be viewed as compliant with CORBA Revision 2.0. Unless 
otherwise specified, a generic reference to CORBA will be presumed to be OMG's CORBA 
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Services Revision 2.0 and a generic reference to CORBA-compliant or to a CORBA platform or 
program or system will be viewed as compliant with CORBA Services Revision 2.0. 
[0009] Any one of these publish/subscribe or object oriented middleware products can be used 
to allow heterogeneous computer systems to communicate with each other. However, 
communication cannot necessarily be established directly from one of these middleware products 
to another. In a computer system using more than one of these middleware services, applications 
that communicate with each other through one service would typically not be able to communicate 
with applications connected to another service. For example, applications that use MQSeries 
would typically not be able to communicate with applications using JMS. Likewise, CORBA 
applications would typically not be able to communicate with either MQSeries or JMS 
applications. A Middleware Brokering System solves this problem by acting as an intermediary 
between the middleware services in a manner analogous to the way the middleware services 
themselves act as intermediaries between disparate individual computer systems. 

SUMMARY OF THE INVENTION 
[0010] The present invention, hereafter referred to as the Middleware Brokering System 
Adapter, is a component useful with a Middleware Brokering System. The Middleware Brokering 
System acts as an intermediary, or meta-middleware, device among different middleware systems. 
Each middleware service can send messages to and receive messages from the Middleware 
Brokering System in its native data format and programming syntax. The Middleware Brokering 
System Adapter transforms data messages from the native format of a middleware computing 
product or a mainframe computing system into a format known as a structured event and from a 
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structured event into the native format of the middleware product or the mainframe system. In an 
embodiment of the invention, the Middleware Brokering System Adapter maps the fields of a 
Cobol copybook onto the fields of a structured event and the fields of a structured event onto the 
fields of a copybook. In an alternative embodiment, the Middleware Brokering System Adapter 
maps the fields of a Java Messaging Service MapMessage onto the fields of a structured event and 
the fields of a structured event onto the fields of a MapMessage. 

DESCRIPTION OF THE DRAWINGS 
[0011] The invention, together with further advantages thereof, may best be understood by 
reference to the following description taken in conjunction with the accompanying drawings in 
which: 

[0012] Figure 1 is a diagrammatic representation of the point-to-point approach to the 
configuration of networks containing heterogeneous computing platforms. 
[0013] Figure 2 is a diagrammatic representation of the hub and spoke approach to multi- 
platform network configuration. 

[0014] Figure 3 is a diagrammatic representation of a computing system containing multiple 
types of middleware connected through the Middleware Brokering System. 

[0015] Figure 4 is a diagrammatic representation of the data format used in the structured 
event. 

DETAILED DESCRIPTION 

[0016] The general operating principles of the invention, hereafter referred to as the 
Middleware Brokering System, can best be understood by reference to Figure 3. Three disparate 
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computing platforms are present: a mainframe system 310, a network 320 of CORBA-compliant 
components 322, 324, 326, and a network 330 of components 332, 334, 336, 338 connected by 
JMS. The mainframe system 310 can comprise any large-scale, centralized computing system. 
The CORBA system can comprise any network of devices complying with the OMG CORBA 
specification previously cited. The JMS system can comprise any network of devices using the 
Java Messaging Service asynchronous messaging system. JMS is a specification developed under 
the leadership of Sun Microsystems and several vendors have released products that implement the 
specification. For purposes of this application, the term JMS refers to any vendor's 
implementation of the JMS specification. The presence of a mainframe system 310, a CORBA 
network 320, and a JMS network 330 is an exemplary embodiment of the invention and the 
Middleware Brokering System may be configured to interconnect a wide variety of middleware 
systems. Other types and numbers of middleware familiar to those of skill in the art could be 
substituted for or added to the examples shown. In addition, the number of components 322, 324, 
326, 332, 334, 336, 338 shown connected to each disparate middleware network is for illustrative 
purposes and the actual number of components in the middleware networks may vary greatly in 
carrying out the invention. 

[0017] In the embodiment of Figure 3, the Middleware Brokering System comprises a 
mainframe adapter 340, a JMS adapter 350, and a message brokering server 360. The mainframe 
adapter 340, the JMS adapter 350, and the message brokering server 360 are software components 
that act virtually as a unit and can reside on the same physical device or on different devices. 
Details of the operation of these components are provided below. In alternative embodiments, 
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other adapters could be used instead of or in addition to the mainframe adapter 340 and the JMS 
adapter 350 if other types of computer systems or middleware products needed to be connected to 
the Middleware Brokering System. A separate CORBA adapter is not needed since CORBA 
applications and the Middleware Brokering System can communicate directly with each other 
using their common data format, the structured event. 

[0018] In a preferred embodiment, the mainframe system 310 uses IBM's MQSeries 
middleware to interact with the Middleware Brokering System. In alternative embodiments, any 
middleware product equivalent to MQSeries may be used to transfer data between the mainframe 
310 and the Middleware Brokering System. When a Cobol program running on the mainframe 
310 needs to send a message to the CORBA network 320, the JMS network 330, or both, the data 
is prepared by placing it in a structure known as a Cobol copybook. In alternative embodiments, 
other mainframe programming languages and other equivalent data structures commonly used in 
those languages could be used to prepare the data. For purposes of this application, the term 
copybook is used to refer to any such data structure. Information about the subject matter of the 
message is included in the copybook which, as described below, will be used by the Middleware 
Brokering System to determine if the subscribers are interested in the message. The program 
running on the mainframe 310 uses a standard programming command to transmit the copybook to 
MQSeries. MQSeries then sends the data to the mainframe adapter 340, described in detail below. 
In alternative embodiments, additional interface layers may exist between the mainframe 310 and 
MQSeries or between MQSeries and the mainframe adapter 340. The mainframe adapter 340 
converts the copybook into a standard format known as a structured event, also described in detail 
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below. The mainframe adapter 340 then sends the message in the structured event format to the 
message brokering server 360. 

[0019] Existing technology requires that mainframe systems use an object request broker to 
communicate with distributed systems. The adapters used in the Middleware Brokering System 
provide an advantage over existing technology by allowing mainframe systems to communicate 
with distributed systems without the use of an object request broker. Dependency on a particular 
vendor's object request brokering product is thus eliminated. 

[0020] The JMS network 330 interacts with the message brokering server 360 in a similar 
manner. The JMS network 330 sends data in its native format, known as a MapMessage, to the 
JMS adapter 350, described in detail below. The JMS adapter 350 converts the data into the 
structured event format and passes it to the message brokering server 360. CORBA-compliant 
applications use the structured event as their native messaging format. Therefore, no conversion 
between messaging formats is needed when the CORBA network 320 needs to publish data. A 
message in the structured event format is sent directly from the CORBA network 320 to the 
message brokering server 360. 

[0021] Other types of computing systems or middleware that might be added to the 
configuration depicted in Figure 3 would publish their data to the message brokering server 360 in 
a similar manner. Where the middleware operates in a native language other than that of the 
Middleware Brokering System, the data would be transmitted to an adapter in the application's 
native format. The adapter would then convert the data into the structured event format and send 
the structured event to the message brokering server 360. The use of the message brokering server 
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360 and the structured event allows mainframe systems and disparate middleware products to 
communicate with each other in a publish/subscribe mode. Only one adapter is needed for each 
disparate type of middleware system to be connected. Without the message brokering server 360 
and the structured event, the different types of systems would need to operate in a point-to-point 
fashion and the number of adapters needed would be greater. 

[0022] Messages received by the message brokering server 360 are passed on to an underlying 
publish/subscribe engine 370. The message brokering server 360 and the publish/subscribe engine 
370 act together as a broker for the messages transferred among the mainframe system 310, the 
CORBA network 320, and the JMS network 330. The message brokering server 360 maintains a 
list of subscribers and the types of messages they have registered to receive. The publish/subscribe 
engine 370 stores the messages in channels that can be configured with various attributes such as 
the number of messages that can be stored on the channel, the length of time messages are to be 
stored on the channel, and the priority of the messages on the channel. When the message 
brokering server 360 finds a match between a message sent to it by one of the publishers and a 
subscriber that has registered an interest in the message, the message brokering server 360 retrieves 
the message from the channels of the publish/subscribe engine 370 and sends the message to the 
appropriate subscriber. Messages are stored in the publish/subscribe engine 370 until the message 
expires or has been delivered to all subscribers successfully. Expiration occurs when the age of the 
message exceeds a preset limit or the number of messages exceeds the limit of the storage 
mechanism. In a preferred embodiment, the publish/subscribe engine 370 is a product developed 
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by Vitria Technology known as BusinessWare. In alternative embodiments, any equivalent 
publish/subscribe engine could be substituted for the Vitria product. 

[0023] The message brokering server 360 retrieves data from the publish/subscribe engine 370 
and passes it in the form of a structured event to the mainframe adapter 340, the JMS adapter 350, 
and/or directly to the CORBA network 320. In a conversion process that is the reverse of the 
process described earlier, the mainframe adapter 340 converts the structured event to a copybook 
and sends the copybook to the mainframe 310. Likewise, the JMS adapter 350 converts the 
structured event into the JMS MapMessage format and sends the MapMessage to the JMS network 
330. In this manner, the mainframe 310, CORBA 320, and JMS 330 systems can send data to and 
receive data from each other in their native formats. The underlying conversion process carried out 
by the Middleware Brokering System is transparent to the participating networks. 
[0024] The message brokering server 360 acts as an abstraction layer on top of the 
publish/subscribe engine 370. Commercially available publish/subscribe engines typically have 
proprietary interfaces that require that data be sent to them in a format specified by the vendor of 
the engine. Therefore, sending of messages directly from adapters such as adapters 340 and 350 to 
the publish/subscribe engine 370 would create vendor dependency. Replacement of one 
publish/subscribe engine 370 with another would require that all adapters 340 and 350 (and any 
others that may be present) be rewritten to accommodate the data format of the new engine. The 
addition of the abstraction layer of the message brokering server 360 allows all adapters 340 and 
350 to remain unchanged. The adapters 340 and 350 merely need to convert from a native data 
format into a structured event. The message brokering server 360 then handles the conversion 
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from the structured event into the proprietary data format of the publish/subscribe engine 370. If a 
different publish/subscribe engine 370 is installed, only minor changes would be needed in the 
message brokering server 360 to allow it to convert from a structured event to the data format of 
the new publish/subscribe engine 370 and these changes will be transparent to other applications. 
[0025] A message is a packet of data in a specified format. The data format used for messages 
in the Middleware Brokering System is known as a structured event and is described in The Object 
Management Group's Notification Service Specification Versions 1.0 and 1.1, which are 
incorporated herein by reference in their entirety and from which the following descriptions of the 
fields in a structured event are taken. The use of a structured event provides a common format for 
all data being transferred within the Middleware Brokering System. As illustrated in Figure 4, the 
structured event data format consists of an event header 420 and an event body 430. The event 
header 420 contains a fixed header 422 and a variable header 424 while the event body 430 
contains filterable body fields 432 and the remaining body 434. 

[0026] Three fields make up the fixed header 422: domain name 425, type name 426, and 
event_name 427. The domain_name field 425 contains a string that identifies the vertical industry 
domain (e.g., telecommunications, healthcare, finance, etc.) within which the type of event that 
characterizes a given structured event is defined. The Middleware Brokering System has adopted 
the following format for the domainjiame 425: [Company]. [Project ID]. [Application 
ID]. [Application Context]. An example could be "Sprint.ION.OM.xDSL". The typejiame field 
426 contains a string that identifies the type of event contained within a given structured event, for 
example, "orderReceived" or "orderProcessed". The domainjiame 425 and the type_name 426 
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jointly make up an event type that is unique among all event types within a particular business 
enterprise. It is this unique event name that is used by publishers to specify the subject matter of 
the messages they are publishing and by subscribers to specify the subject matter of messages they 
are interested in receiving. 

[0027] The event jtiame field 427 contains a string that names a specific instance of structured 
event. Event_names 427 are supplied by the publisher of an event and typically consist of 
sequential numbers, different numbers being given to each event. By providing all events with a 
unique name, the event_name 427, together with the domain_name 425 and the type_name 426, 
allows the Middleware Brokering System to uniquely identify an event on the channel. The 
remainder of the event header 420 of a structured event is contained within the variable header 
424, which contains a sequence of name/value pairs. 

[0028] The event body 430 of a structured event is intended to contain the data portion of a 
message. Its contents are broken down into two sections: the filterable body 432 and the remaining 
body 434. The filterable body 432 portion of the event body 430 of a structured event is a 
sequence of name/value pairs. This portion of the event body 430 holds fields upon which filtering 
is likely to be performed. The remaining body 434 portion of the event body 430 is intended to 
hold event data upon which filtering is not likely to be performed. 

[0029] As discussed previously, the Middleware Brokering System uses adapters to convert 
data into and out of the structured event format. While the following discussion deals only with 
the mainframe and JMS adapters, similar processes would occur in alternative embodiments of the 
invention using other adapters. 
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[0030] When the mainframe 310 needs to publish a message, it places the message in the form 
of a copybook and sends the copybook to the mainframe adapter 340. The mainframe adapter 340 
then converts the copybook into a structured event and sends the structured event to the message 
brokering server 360. Similarly, when the mainframe 310 acts as a subscriber and needs to receive 
a message, the message brokering server 360 sends the message in the form of a structured event to 
the mainframe adapter 340. The mainframe adapter 340 then converts the structured event into a 
copybook and sends the copybook to the mainframe 310. 

[0031] When the mainframe 310 acts as a publisher, data is placed in a copybook with a 
format similar to that below and is sent to the mainframe adapter 340. 


03 


STRUCTURED-EVENT. 
05 EVENT-HEADER. 

10 MB-HEADER. 


15 OP-TYPE 

15 CHANNEL-NAME 


PIC X(04). 
PIC X(256). 


//Renamed 


10 FIXED-EVENT-HEADER. 


15 DOMAIN-NAME 
15 TYPE-NAME 
15 EVENT-NAME 


PIC X(256). 
PIC X(256). 
PIC X(256). 


//New 


//Customer portion of copybook 
03 DATA-HEADER. 

05 DATA 
03 R-DATA REDEFINES DATA-HEADER. 


PIC X(30000). 


05 R-CODE 
05 R-TEXT 
05 FILLER 


PIC 9(04). 
PIC X(3096). 
PIC X(27050). 


[0032] The following is an explanation of each of the fields. 
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[0033] OP-TYPE - This field specifies the operation to be taken by the Middleware Brokering 
System, such as "publish" or "subscribe". 

[0034] CHANNEL-NAME - The name of the channel to which an event is to be published. 
[0035] DOMAIN-NAME - Refers to the domain name in the following format: 

[Company]. [Project ID]. [Application ID]. [Application Context] 
[0036] TYPE-NAME - A string identifying the name of the event (e.g., "orderReceived", 
"orderProcessed") 

[0037] EVENT-NAME - Uniquely identifies the instance of an event. The mainframe 
publisher must supply the EVENT-NAME. 

[0038] DATA - This is the portion of the message that is populated with data for sending to 

the Middleware Brokering System. The data is in the following format: 

If the data is intended for the Filterable Body: 
<FB>key ; length ? value ? key ? length ? value</FB> 

If the data is intended for the Remainder of Body: 
Blob of data 

[0039] R-DATA -These fields are used by the mainframe adapter 340 to inform the 
mainframe 310 whether or not a message has been successfully transmitted from the mainframe 
310 to the message brokering server 360. 

[0040] A program running on the mainframe 310 uses standard commands to populate the 
copybook and send the copybook to the mainframe adapter 340. The mainframe adapter 340 
converts the copybook into a structured event by mapping the copybook fields onto the structured 
event fields. DOMAIN-NAME in the copybook is mapped onto domain_name 425 in the 
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structured event, TYPE-NAME in the copybook is mapped onto type name 426 in the structured 
event, EVENT-NAME in the copybook is mapped onto eventjiame 427 in the structured event, 
and DATA in the copybook is mapped onto the remaining body 434 in the structured event. The 
mainframe adapter 340 then sends the structured event to the message brokering server 360 which 
stores it in the underlying publish/subscribe engine 370. The message brokering server 360 
compares the data in the domainname 425 and type name 426 portions of the structured event to 
the domain names and type names that subscribers have registered an interest in. If the message 
brokering server 360 finds a match between the domain_name 425 and type_name 426 supplied by 
a publisher and a domain name and type name registered by a subscriber, the message brokering 
server 360 retrieves the appropriate message from the publish/subscribe engine 370 and sends the 
message to the appropriate subscriber. 

[0041] The mainframe adapter 340 has the capability to notify the mainframe 310 whether or 
not a message was successfully transmitted from the mainframe 310 to the message brokering 
server 360. The R-DATA portion of the copybook contains a field called R-CODE into which the 
mainframe adapter 340 inserts values indicating whether the transmission was successful. When 
the mainframe 310 attempts to send a message to the message brokering server 360, the mainframe 
adapter 340 determines whether the transmission was successful, populates the R-CODE field with 
the appropriate return code to indicate success or failure, and sends the message back to the 
mainframe 310. It is the responsibility of the mainframe application that published the message to 
check this field and determine the appropriate action if the transmission was unsuccessful. 


51645.01/4000.02000 


17 


[0042] The mainframe 310 subscribes to events by sending the CHANNEL-NAME, 
DOMAIN-NAME, and TYPE-NAME of the events in which it has an interest to the mainframe 
adapter 340. The mainframe adapter 340 stores this data in a file to which the message brokering 
server 360 has access. If the message brokering server 360 finds a match between a CHANNEL- 
NAME, DOMAIN-NAME, and TYPE-NAME subscribed to by the mainframe 310 and the data in 
similar fields published by another application, the message brokering server 360 sends the 
appropriate message to the mainframe 310. 

[0043] Any event subscribed to by the mainframe 310 will be sent from the Middleware 
Brokering System in the generic copybook format shown above unless a different format is 
specifically provided by the publisher of the event. The mainframe adapter 340 will take the data 
in the filterable body 432 of the structured event and convert it into a 
"key,length,value,key,length 5 value" format string. This string will populate the DATA portion of 
the copybook which will then be sent to the mainframe 310. If the filterable body 432 contains 
data in anything other than a string format, the mainframe adapter 340 will not convert it to the 
string format. Instead, the mainframe adapter 340 will insert the characters 'BAD_DATA' in the 
place where the data would go. If an event needs to be sent in a format other than that of the 
generic copybook, the publisher of the event is responsible for mapping the structured event onto 
the specific copybook to be used. If the generic copybook is used, any data in the remaining body 
field 434 will be ignored. 

[0044] Similar to the case when the mainframe 310 acts as a publisher, the copybook contains 
a field that allows values to be inserted indicating whether the copybook was successfully 
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transferred from the message brokering server 360 to the mainframe 310. The mainframe adapter 
340 periodically checks this field and resends the message if a delivery failure is indicated. 
[0045] Java Messaging Service (JMS) is a specification for an asynchronous messaging system 
developed under the leadership of Sun Microsystems that allows programs written in the Java 
programming language to communicate with other message services. Vendors including Sun 
Microsystems offer products that implement the JMS specification. For purposes of this 
application, the term JMS refers to any JMS implementation. A JMS message has three parts: a 
header, an optional properties section, and an optional body section. The header contains ten 
predefined fields used to identify and route messages: JMSDestination, JMSDeliveryMode, 
JMSExpiration, JMSPriority, JMSMessagelD, JMSTimestamp, JMSCorrelationID, JMSReplyTo, 
JMSType, and JMSRedelivered. The optional properties section may be used if additional 
message properties beyond those provided by the header are needed. JMS provides five message 
body formats, known as message types: MapMessage, TextMessage, BytesMessage, 
StreamMessage, and ObjectMessage. The MapMessage type contains a set of name/value pairs 
and is the preferred message type for messages transmitted to and from the Middleware Brokering 
System since it maps easily with a structured event. 

[0046] When the JMS network 330 needs to publish a message, a JMS application places the 
message in the form of a JMS MapMessage and sends the MapMessage to the JMS adapter 350. 
The JMS adapter 350 then converts the MapMessage into a structured event by mapping the fields 
in the MapMessage to the fields in the structured event. The domain name and type name 
properties of the message are concatenated by the JMS application in the form 
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DomainName:TypeName and are placed in the JMSType field in the header section of the 
MapMessage. The JMS adapter 350 maps the DomainName portion of the concatenated JMSType 
field onto the domainname 425 field in the fixed header 422 of the structured event and maps the 
TypeName portion of the concatenated JMSType field onto the type_name 426 field in the fixed 
header 422 of the structured event. If the JMS application does not properly set the JMSType 
field, the JMS adapter 350 populates this field with a default value. The MapMessage does not 
supply a value for the event_name 427 field in the structured event. This field is instead set by the 
message brokering server 360 upon receipt of a message. 

[0047] Other fields in the header section of the MapMessage are mapped onto the variable 
header 424 section of the structured event. The JMSMessagelD field in the MapMessage is 
mapped onto a field given the name JMSMessagelD in the variable header 424 of the structured 
event, the JMSTimestamp field in the MapMessage is mapped onto a field given the name 
JMSTimestamp in the structured event, and the JMSDeliveryMode field in the MapMessage is 
mapped onto a field given the name EventReliability in the structured event. The remaining JMS 
header fields are not mapped. 

[0048] The properties section of a JMS message, if used, is mapped onto the filterable body 
432 section of a structured event. The JMS adapter 350 maps fields with one of Java's primitive 
data types (boolean, byte, short, integer, long, float, double, and string) directly onto fields with 
similar data types in the filterable body 432. The body section of a JMS message, if used, is 
mapped onto the remaining body 434 of a structured event. When the recommended MapMessage 
body format is used, the JMS adapter 350 maps fields with one of the primitive data types directly 
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onto fields with similar data types in the remaining body 434. For both the properties and body 
sections of a JMS MapMessage, if a user defined data type is used instead of a Java primitive data 
type, the JMS adapter 350 maps the data with a string data type and a value of 
"UNKNOWN^DATA". 

[0049] When the JMS adapter 350 completes the mapping of a JMS MapMessage to a 
structured event, the JMS adapter 350 sends the structured event to the message brokering server 
360. The message brokering server 360 and the publish/subscribe engine 370 then act together as a 
message broker and match the published message with interested subscribers in a process similar 
to that previously described for the mainframe adapter 340. 

[0050] When the JMS network 330 acts as a subscriber and needs to receive a message, the 
message brokering server 360 sends the message in the form of a structured event to the JMS 
adapter 350. The JMS adapter 350 then converts the structured event into a MapMessage and 
sends the MapMessage to the JMS network 330. The domainname 425, typejtiame 426, and 
event_name 427 fields of the fixed header 422 in the structured event are mapped onto the header 
section of the JMS MapMessage. The JMS adapter 350 concatenates the domainname 425 and 
type_name 426 fields into a single value with the format DomainName:TypeName and places that 
value in the JMSType field of the JMS header. The event jiame 427 field of the structured event is 
mapped onto the JMSCorrelationID field of the MapMessage. The structured event received from 
the message brokering server 360 contains a field named Timestamp in the variable header 424 
section that indicates the time the message brokering server 360 received the message. This field 
is mapped onto a field in the properties section of the MapMessage called MBTimestamp. The 
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filterable body 432 section of the structured event is mapped onto the properties section of the 
MapMessage and the remaining body 434 section of the structured event is mapped onto the body 
section of the MapMessage. Similar to the case when the JMS network 330 acts as a publisher, the 
JMS adapter 350 maps fields with one of the primitive data types in the filterable body 432 and 
remaining body 434 sections of the structured event directly onto fields with similar data types in 
the properties and body sections of the MapMessage. For both the filterable body 432 and 
remaining body 434 sections of the structured event, if a user defined data type is used instead of a 
Java primitive data type, the JMS adapter 350 maps the data with a string data type and a value of 
"UNKNOWNJDATA". 

[0051] Quality of service refers to the capability of a messaging system to verify the integrity 
of message delivery and includes features such as the priority of the message, verification of 
delivery, and delivery date and time. Users of the Middleware Brokering System can use the 
quality of service attributes to customize the message brokering functionality to meet their needs 
by designating whether they want, for example, guaranteed delivery at a slower transmission rate 
or a high transmission rate but no guarantee of delivery. Quality of service is achieved in the 
Middleware Brokering System through the properties of the channels in the publish/subscribe 
engine 370. Each channel is assigned different quality of service attributes and a publishing 
application with particular quality of service requirements will specify that the message it is 
sending must be transmitted on the channel whose attributes match its requirements. Alternatively, 
an application can create its own channel and define its own quality of service attributes. With 
existing technologies, mainframe Cobol systems cannot include quality of service attributes when 
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communicating with distributed systems in a publish/subscribe mode. By using Cobol copybooks 
that are converted into structured events and stored in the channels of a publish/subscribe engine, 
the Middleware Brokering System provides quality of service attributes to these systems. 
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